curl --request GET \
--url https://sandbox.prezio.eu/api/tariffs/{id}/ \
--header 'Authorization: <api-key>'
{
"id": "tar_45",
"name": "Advanced Business Tariff",
"has_time_of_use": true,
"has_tiers": true,
"has_calculation_input": true,
"has_properties": true,
"local_consumer_types": [
{
"id": "lct_123",
"key": "b_low",
"name": "Business Low Voltage",
"consumer_type": "BUSINESS"
}
],
"context": {
"organization": {
"id": "org_285",
"name": "Copenhagen DSO",
"type": "DSO"
},
"main_tariff": {
"id": "mta_33",
"name": "Advanced Pricing",
"description": "Time-variable pricing with demand components"
}
},
"tariff_properties": [
{
"id": "pro_15",
"key": "contract_type",
"name": "Contract Type",
"data_type": "CHOICE",
"group_key": "tariff_type",
"group_name": "Tariff Type",
"question": "What type of electricity contract do you prefer?",
"description": "Different pricing structures available",
"choices": [
{
"id": "prv_13",
"name": "Spot",
"value": "spot"
}
]
},
{
"id": "pro_16",
"key": "price_duration",
"name": "Price Variability Duration",
"data_type": "CHOICE",
"group_key": "tariff_type",
"group_name": "Tariff Type",
"question": "How often do you want price updates?",
"description": "Frequency of price changes",
"choices": [
{
"id": "prv_41",
"name": "Hourly",
"value": "1h"
}
]
}
],
"tou_levels": [
{
"id": "tou_146",
"name": "Peak",
"type": "ON_PEAK",
"periods": [
{
"from_time": "17:00",
"to_time": "20:59",
"from_day": 1,
"to_day": 5,
"summary": "Mon-Fri: 17:00-20:59"
}
]
},
{
"id": "tou_162",
"name": "Partial peak",
"type": "PARTIAL_PEAK",
"periods": [
{
"from_time": "05:00",
"to_time": "16:59",
"from_day": 1,
"to_day": 5,
"summary": "Mon-Fri: 05:00-16:59"
},
{
"from_time": "21:00",
"to_time": "23:59",
"from_day": 1,
"to_day": 5,
"summary": "Mon-Fri: 21:00-23:59"
}
]
},
{
"id": "tou_145",
"name": "Off-peak",
"type": "OFF_PEAK",
"periods": [
{
"from_time": "00:00",
"to_time": "04:59",
"from_day": 1,
"to_day": 0,
"summary": "Mon-Sun: 00:00-04:59"
}
]
}
],
"components": [
{
"id": "com_1889",
"name": "TOU Demand",
"key": "tou_demand",
"description": "Time-of-use demand charge",
"type": "DEMAND",
"unit": "kw_per_month",
"direction": "IMP",
"has_time_of_use": true,
"has_tiers": false,
"has_calculation_input": true,
"has_properties": false,
"applicable_vat_rate": "standard",
"from": "2025-01-01T00:00:00+01:00",
"to": "2025-12-31T23:59:59+01:00",
"calculation_requirements": [
{
"type": "CALCULATION_INPUT",
"key": "peak_demand",
"name": "Peak Demand",
"input_unit": "KW",
"input_period": "MONTH",
"choices": [
{
"key": "peak_demand_single",
"type": "SINGLE_VALUE"
}
]
},
{
"type": "TOU_LEVEL",
"key": "tou",
"name": "Time of Use Level",
"choices": [
{
"id": "tou_146",
"type": "ON_PEAK"
},
{
"id": "tou_162",
"type": "PARTIAL_PEAK"
},
{
"id": "tou_145",
"type": "OFF_PEAK"
}
]
}
]
},
{
"id": "com_15555",
"name": "Energy Consumption (kWh)",
"key": "kwh",
"description": "Variable energy consumption charge",
"type": "KWH",
"unit": "kwh",
"direction": "IMP",
"has_time_of_use": true,
"has_tiers": false,
"has_calculation_input": true,
"has_properties": true,
"applicable_vat_rate": "standard",
"from": "2025-01-01T00:00:00+01:00",
"to": null,
"calculation_requirements": [
{
"type": "CALCULATION_INPUT",
"key": "consumption",
"name": "Energy Consumption (kWh)",
"input_unit": "KWH",
"input_period": null,
"choices": [
{
"key": "consumption_profile",
"type": "TIME_SERIES"
},
{
"key": "consumption_total",
"type": "SINGLE_VALUE"
}
]
},
{
"type": "TOU_LEVEL",
"key": "tou",
"name": "Time of Use Level",
"choices": [
{
"id": "tou_146",
"type": "ON_PEAK"
},
{
"id": "tou_162",
"type": "PARTIAL_PEAK"
},
{
"id": "tou_145",
"type": "OFF_PEAK"
}
]
}
]
},
{
"id": "com_15552",
"name": "Capacity Fuses",
"key": "capacity_fuses",
"description": "Fixed charge based on fuse level",
"type": "FIXED",
"unit": "per_month",
"direction": "IMP",
"has_time_of_use": false,
"has_tiers": false,
"has_calculation_input": false,
"has_properties": true,
"applicable_vat_rate": "standard",
"from": "2025-01-01T00:00:00+01:00",
"to": null,
"calculation_requirements": [
{
"type": "PRICE_PROPERTY",
"key": "fuse_level",
"name": "Fuse Level",
"data_type": "CHOICE",
"choices": [
"16",
"20",
"25"
]
}
]
},
{
"id": "com_15551",
"name": "Energy Tax",
"key": "energy_tax",
"description": "Government energy tax",
"type": "TAX",
"unit": "percent",
"direction": "IMP",
"has_time_of_use": false,
"has_tiers": false,
"has_calculation_input": false,
"has_properties": false,
"applicable_vat_rate": "standard",
"from": "2025-07-01T00:00:00+02:00",
"to": null
}
]
}
Returns comprehensive information about a specific tariff including its components, properties, and pricing structure.
This endpoint is particularly useful for advanced pricing calculations as it includes all the calculation requirements.
Required: id
is required.
This endpoint is currently in beta. Errors may happen. Changes may occur.
curl --request GET \
--url https://sandbox.prezio.eu/api/tariffs/{id}/ \
--header 'Authorization: <api-key>'
{
"id": "tar_45",
"name": "Advanced Business Tariff",
"has_time_of_use": true,
"has_tiers": true,
"has_calculation_input": true,
"has_properties": true,
"local_consumer_types": [
{
"id": "lct_123",
"key": "b_low",
"name": "Business Low Voltage",
"consumer_type": "BUSINESS"
}
],
"context": {
"organization": {
"id": "org_285",
"name": "Copenhagen DSO",
"type": "DSO"
},
"main_tariff": {
"id": "mta_33",
"name": "Advanced Pricing",
"description": "Time-variable pricing with demand components"
}
},
"tariff_properties": [
{
"id": "pro_15",
"key": "contract_type",
"name": "Contract Type",
"data_type": "CHOICE",
"group_key": "tariff_type",
"group_name": "Tariff Type",
"question": "What type of electricity contract do you prefer?",
"description": "Different pricing structures available",
"choices": [
{
"id": "prv_13",
"name": "Spot",
"value": "spot"
}
]
},
{
"id": "pro_16",
"key": "price_duration",
"name": "Price Variability Duration",
"data_type": "CHOICE",
"group_key": "tariff_type",
"group_name": "Tariff Type",
"question": "How often do you want price updates?",
"description": "Frequency of price changes",
"choices": [
{
"id": "prv_41",
"name": "Hourly",
"value": "1h"
}
]
}
],
"tou_levels": [
{
"id": "tou_146",
"name": "Peak",
"type": "ON_PEAK",
"periods": [
{
"from_time": "17:00",
"to_time": "20:59",
"from_day": 1,
"to_day": 5,
"summary": "Mon-Fri: 17:00-20:59"
}
]
},
{
"id": "tou_162",
"name": "Partial peak",
"type": "PARTIAL_PEAK",
"periods": [
{
"from_time": "05:00",
"to_time": "16:59",
"from_day": 1,
"to_day": 5,
"summary": "Mon-Fri: 05:00-16:59"
},
{
"from_time": "21:00",
"to_time": "23:59",
"from_day": 1,
"to_day": 5,
"summary": "Mon-Fri: 21:00-23:59"
}
]
},
{
"id": "tou_145",
"name": "Off-peak",
"type": "OFF_PEAK",
"periods": [
{
"from_time": "00:00",
"to_time": "04:59",
"from_day": 1,
"to_day": 0,
"summary": "Mon-Sun: 00:00-04:59"
}
]
}
],
"components": [
{
"id": "com_1889",
"name": "TOU Demand",
"key": "tou_demand",
"description": "Time-of-use demand charge",
"type": "DEMAND",
"unit": "kw_per_month",
"direction": "IMP",
"has_time_of_use": true,
"has_tiers": false,
"has_calculation_input": true,
"has_properties": false,
"applicable_vat_rate": "standard",
"from": "2025-01-01T00:00:00+01:00",
"to": "2025-12-31T23:59:59+01:00",
"calculation_requirements": [
{
"type": "CALCULATION_INPUT",
"key": "peak_demand",
"name": "Peak Demand",
"input_unit": "KW",
"input_period": "MONTH",
"choices": [
{
"key": "peak_demand_single",
"type": "SINGLE_VALUE"
}
]
},
{
"type": "TOU_LEVEL",
"key": "tou",
"name": "Time of Use Level",
"choices": [
{
"id": "tou_146",
"type": "ON_PEAK"
},
{
"id": "tou_162",
"type": "PARTIAL_PEAK"
},
{
"id": "tou_145",
"type": "OFF_PEAK"
}
]
}
]
},
{
"id": "com_15555",
"name": "Energy Consumption (kWh)",
"key": "kwh",
"description": "Variable energy consumption charge",
"type": "KWH",
"unit": "kwh",
"direction": "IMP",
"has_time_of_use": true,
"has_tiers": false,
"has_calculation_input": true,
"has_properties": true,
"applicable_vat_rate": "standard",
"from": "2025-01-01T00:00:00+01:00",
"to": null,
"calculation_requirements": [
{
"type": "CALCULATION_INPUT",
"key": "consumption",
"name": "Energy Consumption (kWh)",
"input_unit": "KWH",
"input_period": null,
"choices": [
{
"key": "consumption_profile",
"type": "TIME_SERIES"
},
{
"key": "consumption_total",
"type": "SINGLE_VALUE"
}
]
},
{
"type": "TOU_LEVEL",
"key": "tou",
"name": "Time of Use Level",
"choices": [
{
"id": "tou_146",
"type": "ON_PEAK"
},
{
"id": "tou_162",
"type": "PARTIAL_PEAK"
},
{
"id": "tou_145",
"type": "OFF_PEAK"
}
]
}
]
},
{
"id": "com_15552",
"name": "Capacity Fuses",
"key": "capacity_fuses",
"description": "Fixed charge based on fuse level",
"type": "FIXED",
"unit": "per_month",
"direction": "IMP",
"has_time_of_use": false,
"has_tiers": false,
"has_calculation_input": false,
"has_properties": true,
"applicable_vat_rate": "standard",
"from": "2025-01-01T00:00:00+01:00",
"to": null,
"calculation_requirements": [
{
"type": "PRICE_PROPERTY",
"key": "fuse_level",
"name": "Fuse Level",
"data_type": "CHOICE",
"choices": [
"16",
"20",
"25"
]
}
]
},
{
"id": "com_15551",
"name": "Energy Tax",
"key": "energy_tax",
"description": "Government energy tax",
"type": "TAX",
"unit": "percent",
"direction": "IMP",
"has_time_of_use": false,
"has_tiers": false,
"has_calculation_input": false,
"has_properties": false,
"applicable_vat_rate": "standard",
"from": "2025-07-01T00:00:00+02:00",
"to": null
}
]
}
Token-based authentication with required prefix "Token"
Tariff ID with "tar_" prefix or raw integer (e.g., "tar_789", "789")
Include tariff_properties (similar to the data from the list endpoint) section in response (default: false)
Include detailed information about tou_levels including periods (default: false)
Filter components to show only those with active prices at the specified datetime. Also determines the validity range shown in component 'from' and 'to' fields, and affects the calculation of tariff-level flags. Format: 'YYYY-MM-DDTHH:MM:SS' (ISO 8601). If not provided, uses current time.
OK
The response is of type object
.
Was this page helpful?